Repository navigation
docs: accept RFC-0038 (collection permalinks) and RFC-0039 (site archives), ADR-0040/0041 - #61
Merged
Merged
Conversation
RFC-0038 (#50): an optional base path per collection in the site (`Site.collections.<key>.basePath`, default `/<collection>`), one `entryPath` for the ~15 inline copies, and a prefix redirect when it changes, as taxonomy archives already do. RFC-0039 (#47): `cloudhal export` / `cloudhal import` with a `.cloudhal` file: a gzipped tar of a manifest, the existing SiteBundle JSON and the media bytes; keeps the site id; graph only, no people or personal data. Co-Authored-By: Claude Opus 5.5 <[email protected]> Signed-off-by: Madraka <[email protected]>
…ives)
Revised before acceptance after comparing WordPress, Ghost, Hugo, Webflow,
Eleventy and the headless CMSs (URLs), and Sanity, Strapi, Contentful,
Ghost, WordPress, Directus and Webflow (exports):
- RFC-0038: `permalink` (closed token set, v1 `/<prefix>/{slug}`) instead
of `basePath`, so tokens can come without a rename; `entryPath`/`entryAt`
both ways; redirects derived from the change; later items decided.
- RFC-0039: NDJSON parts instead of one bundle.json (streaming), per-file
SHA-256 and contract versions in the manifest, a `before import` snapshot
for `--replace`, no built-in encryption; later items decided.
- ADR-0040, ADR-0041.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Signed-off-by: Madraka <[email protected]>
Madraka
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Both RFCs are Accepted (decided by Halil, 2026-10-22), revised before acceptance after a comparison with other platforms, and recorded as ADR-0040 and ADR-0041.
RFC-0038: Collection permalinks → ADR-0040 (#50)
Site.collections.<key>.permalink, default/<collection>/{slug}. v1 accepts only fixed segments plus/{slug}(schema pattern), with a closed token set. Namedpermalink, notbasePath, so tokens come later without a rename (WordPress, Ghost and Hugo all ended up with templates).entryPath(site, entry)andentryAt(site, path)in core-ts replace about 15 inline copies.indexPath,{category}.RFC-0039: Site archives → ADR-0041 (#47)
cloudhal export/importwith a.cloudhalfile: a gzipped ustar ofnodes|snapshots|blobs/NNNN.ndjsonparts (≤ 8 MB, streaming like Sanity and Strapi),media/<sha256>,project.json,ledger.ndjson. Read back in order, the parts are exactly acloudhal.site-bundle@1.schemaVersion, and every file's SHA-256 and size. Newer versions are refused; older ones are migrated forward.--replace(takes abefore importsnapshot first; never erase-then-import like Strapi), and--dry-runwith a diff.age/gpginstead.init --from,--new-ids, partial export,--from <admin-url>, Studio download, signing.🤖 Generated with Claude Code